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PREFACE 


This  product  specification  covers  the  work  performed  under 
Air  Force  Contract  F33615-80-C-5155  (ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory,  Air  Force 
Systems  Command,  Wright-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker,  ICAM  Program  Manager,  Manufacturing  Technology 
Division,  through  Project  Manager,  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Schenectady,  New  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany,  New  York. 


Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 

Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 

D.  Appleton  Company 
(DACOM) 


Role 

Reviewer 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search 


General  Dynamics/  Responsible  for  factory  view 

Ft.  Worth  function  and  information 

models 
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Role 


Subcontractors ' 

Illinois  Institute  of 
Technology 

North  American  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
SofTech 

TASKS  4. S  -  4.9  (TEST  BED) 

Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 

Computer  Technology 
Associates  (CTA) 

Control  Data  Corporation 
(CDC) 


D.  Appleton  Company 
CDACOM) 


Responsible  for  factory  view 
function  research  (IITRI) 
and  Information  models  of 
small  and  medium-size  business 


Responsible  for  factory  view 
function  and  information 
models 

Responsible  for  IDEF2  support 
Responsible  for  IDEFO  support 


Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  computer  technology. 

Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 

Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DACOM). 

Responsible  for  the  overall  CDM 
Subsystem  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsys terns . 


Reviewer 


Role 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (DEC) 


McDonnell  Douglas 
Automation  Company 
(McAuto) 


On-Line  Software 
International  (OSI) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation. 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 

Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
became  McCormack  &  Dodge) 


Sof Tech .  Inc . 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Other  prime  contractors  under  other  projects  who  have 
contributed  to  Test  Bed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


Contractors 


ICAM  Project  Contributing  Activities 


Boeing  Military 
Aircraft  Company 
(BMAC) 


1701,  2201,  Enhancements  for  IBM 
2202  node  use.  Technology 

Transfer  to  Integrated 
Sheet  Metal  Center 
(ISMC) 
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Contractors 

Control  Data 
Corporation  (CDC) 


D.  Appleton  Company 
(DAOOM) 

General  Electric 


Hughes  Aircraft 
Company  (HAC) 

Structural  Dynamics 
Research  Corporation 
(SDRC) 


Systran 


ICAM  Project  Contributing  Activities 

1502,  1701  IISS  enhancements  to 
Common  Data  Model 
Processor  (CDMP) 


1502  IISS  enhancements  to 

Integration  Methodology 

1502  Operation  of  the  Test 

Bed  and  communications 
equipment . 

Test  Bed  enhancements 


1502,  1701,  IISS  enhancements  to 

User  Interface/Virtual 
Terminal  Interface 
(UI/VTI ) 

1502  Test  Bed  enhancements. 

Operation  of  Test  Bed. 
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SECTION  1 


SCOPE 


1 . 1  Ident i f i cat i on 

"  y  This  specif icationr establishes  the  design  of  Function  PRE6 , 
^Select  IS  Access  Path“^“  one  of  the  major  functions  of  the 
Configuration  Item  ^ Precomp i  ler”'  to  be  built  and  formally 
accepted  by  the  ICAM  Program  Office.  This  Cl  constitutes  one  of 
the  subsystems  of  the  Common  Data  Model  Processor,  (CDMP). 

1.2  Functional  Flow 


The  purpose  of  this  Computer  Program  Configuration  Item 
(CPCI)  is  to  select  an  internal  schema  access  path  through  a 
CODASYL  database  to  satisfy  an  NDML  subtransaction  request. 

The  following  functions  will  be  performed  by  the  CPCI: 

\ 

1.  Determine  if  a  calc  key  search  of  the  database  is 
possible. 

J 

\ 

2.  Determine  if  an  area  sweep  of  the  database  is  required. 

3 j  Construct  the  optimal  access  path  through  the  database 
in  generic  access  path  specification  code  terms  using 
data  from  the  internal  schema  tables. 

^ _ _ _ 

V 
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SECTION  2 


DOCUMENTS 


2 . 1  Reference  Documents 


1.  ICAM  Documentation  Standards:  IDS15012000A.  28 
December  1981. 

2.  D.  Appleton  Co.,  CDM  Administrators  Manual: 

UM620 141 000 ,  March  1984. 

3.  D.  Appleton  Co.,  CDM1-IDEF,  Model  of  the  Common  Data 
Model:  CCS620 141 000 ,  15  May,  1985. 

4.  D.  Appleton  Co..  Computer  Program  Development 
Specification  (DS)  for  ICAM  Integrated  Support  System 
(IISS)  Configuration  Item:  NDML  Precompiler: 

DS620 141 200 ,  October  1984. 

5.  D.  Appleton  Co.,  Embedded  NDML  Programmer's  Reference 

Manual:  PRM620141200 ,  March,  1985. 

6.  Softech,  Inc.,  NTM  Programmer's  Guide:  UM620140001 , 
July,  1984. 

7.  Control  Data  Corp. ,  Computer  Program  Development 
Specification  (DS)  for  ICAM  Integrated  Support  System 
(IISS)  Configuration  Item:  NDDL  Command  Processor: 
DS620141 100 ,  June  1985 

2.2  Terms  and  Abbreviations 


Attribute  Use  Class:  (AUC) 

Conceptual  Schema:  (CS) 

Common  Data  Model  Processor:  (CDMP) 

Common  Data  Model :  (CDM)  Describes  common  data  application 
process  formats,  form  definitions,  etc,  of  the  IISS  and  includes 
conceptual  schema,  external.  Internal  schemas,  and  schema 
transformation  operators. 
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Data  Field:  (DF)  An  element  of  data  in  the  external 
schema.  It  is  by  this  name  that  an  NDML  programmer  references, 
data . 


Database  Management  System:  (DBMS) 

Distributed  Request  Supervisor:  (DRS)  This  IISS  CDM 
subsystem  configuration  item  controls  the  execution  of 
distributed  NDML  queries  and  non  distributed  updates. 

Domain :  A  logical  definition  of  legal  attribute  class 

values . 

Domain  Constraint:  Predicate  that  applies  to  a  single 
domain . 

External  Schema:  (ES) 

Forms :  Structured  views  which  may  be  imposed  on  windows  or 
other  forms.  A  form  is  composed  of  fields  where  each  field  is  a 
form,  item,  or  window. 

Forms  Processor:  (FP)  A  set  of  callable  execution  time 
routines  available  to  an  application  program  for  form 
processing . 

Internal  Schema:  (IS) 

Integrated  Information  Support  System:  (IISS)  A  test 
computing  environment  used  to  investigate,  demonstrate  and  test 
the  concepts  of  information  management  and  information 
Integration  in  the  context  of  Aerospace  Manufacturing.  The  IISS 
addresses  the  problems  of  integration  of  data  resident  on 
heterogeneous  databases  supported  by  heterogeneous  computers 
interconnected  via  a  local  Area  Network. 

Mapping :  The  correspondence  of  independent  objects  in  two 

schemas:  ES  to  CS  or  CS  to  IS. 

Network  Transaction  Manager:  (NTM)  Performs  the 
coordination,  communication  and  housekeeping  functions  required 
to  Integrate  the  application  processes  and  system  services 
resident  on  the  various  hosts  into  a  cohesive  system. 

Neutral  Data  Manipulation  Language:  (NDML)  A  language 
developed  by  the  IISS  project  to  provide  uniform  access  to 
common  data,  regardless  of  database  manager  or  distribution 
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criteria.  It  provides  distributed  retrieved  and  single  node 
updates . 

ORACLE :  Relational  DBMS  based  on  the  SQL  (Structured  Query 

Language,  a  product  of  ORACLE  Corp,  Menlo  Park.  CA).  The  Cm  is 
an  ORACLE  database . 

Parcel:  A  sequential  file  containing  sections  of  source 

code  of  the  input  Application  Program. 

Request  Processor:  (RP)  A  COBOL  program  that  will  satisfy 
a  retrieval  or  update  NDML  sub transact  ion  against  a  particular 
Database  Management  System. 

User  Interface :  (01)  Controls  the  user's  terminal  and 

interfaces  with  the  rest  of  the  system. 
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Virtual  Terainal  Interface:  (VTI)  Perforas  the  interfacing 
between  different  terainals  and  the  01 .  This  is  done  by 
defining  a  specific  set  of  terainal  features  and  protocols  which 
aust  be  supported  by  01  software  which  constitutes  the  Virtual 
Terainal  Definition  Specific  terainals  are  then  aapped  against 
the  Virtual  Terainal  software  by  specific  software  aodules 
written  for  each  type  of  real  terainal  supported. 
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SECTION  3 
REQUIREMENTS 


5.1  Structural  Description 


The  graphic  portrayal  of  this  CPCI  is  included  in  Section 
3.10.  This  chart  shows  the  hierarchical  relationship  of  each 
module  making  up  this  CPCI. 


This  CPCI  uses  a  lower  level  module  to  identify  complete 
internal  schema  primary  or  secondary  keys  in  the  NDML  request 
(CDPR7KY). 


3.2  Functional  Flow 

This  CPCI  implemented  the  logic  defined  in  the  Development 
Specification  for  this  CPCI.  Details  of  inputs/ outputs  ami 
relationships  between  modules  are  found  in  Section  3.10. 

This  CPCI  has  been  designated  to  operate  in  a  batch  or 
interactive  mode.  It  must  operate  in  the  system  environment 
established  for  IISS;  that  is.  the  Network  Transaction  Manager. 
The  ORACLE  DBMS  installed  on  a  DEC  VAX  computer  must  be  used. 

3.3  Interfaces 

The  following  diagram  depicts  the  interface  of  PRE6  with 
other  CPCI's  in  the  system. 


+ - + 

I  CDP13  I 
I  PS41210  I 
I  I 

+ - + - + 

I 

I 

+ - + - + 

I  I 

I  PRE6  I 
I  f 

+ - + 
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3.3.1  Inputs /Outputs 

The  following  table  depicts  the  inputs  and  outputs  of  this 
CPCI .  A  detailed  description  for  each  item  can  be  found  in  the 
PS  for  this  CPCI. 

FUNCTION :  PRE6 

INPUT  OUTPUT 


Database  Identification  Number 
Current  Subtransaction 
Internal  Schema  Action  List 
Internal  Schema  Qualify  List 
Set  Table 

ORACLE  Logon  Data  Area 
Error  File  Name 


3.4  Program  Interrupts 

Not  applicable  to  the  CPCI. 

3.5  Timing  and  Sequencing  Description 

This  CPCI  is  activated  for  each  CODASYL  database 
subtransaction  constructed  by  PRE5.  The  timing  and  sequence  of 
the  call  to  this  CPCI  is  determined  by  the  support  routines 
CDP13 . 

3.6  Special  Control  Features 
Not  applicable  to  this  CPCI. 

3 . 7  Storage  Allocation 

3.7.1  Database  Definition 


Access  Path  Specification 
Code  Table 

Record  Key  Table 
Access  Path  Data 
Information  Table 
Error  status  code 


The  database  used  by  this  CPCI  is  the  Common  Data  Model 
(CDM)  database.  The  model  is  defined  by  the  CDM1 ,  the  IDEF1 
model  of  the  CDM,  Reference  Document  Number  3. 

3. 7. 1.1  File  Description 
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SECTION  3 

REQUIREMENTS 


Structural  Description 


The  graphic  portrayal  of  this  CPCI  is  included  in  Section 
3.10.  This  chart  shows  the  hierarchical  relationship  of  each 
nodule  making  up  this  CPCI. 


This  CPCI  uses  a  lower  level  module  to  identify  complete 
internal  schema  primary  or  secondary  keys  in  the  HDML  request 
( CDPR7KY ) . 


3.2  Functional  Flow 

This  CPCI  implemented  the  logic  defined  in  the  Development 
Specification  for  this  CPCI.  Details  of  inputs /outputs  and 
relationships  between  modules  are  found  in  Section  3.10. 

This  CPCI  has  been  designated  to  operate  in  a  batch  or 
interactive  mode.  It  must  operate  in  the  system  environment 
established  for  IISS;  that  is,  the  Network  Transaction  Manager. 
The  ORACLE  DBMS  installed  on  a  DEC  VAX  computer  must  be  used. 

3.3  Interfaces 

The  following  diagram  depicts  the  interface  of  PRE6  with 
other  CPCI's  in  the  system. 
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3.3.1  Inputs/Outputs 

The  following  table  depicts  the  inputs  and  outputs  of  this 
CPCI .  A  detailed  description  for  each  item  can  be  found  in  the 
DS  for  this  CPCI. 

FUNCTION :  PRE6 

INPUT  OUTPUT 


Database  Identification  Number 
Current  Subtransaction 
Internal  Schema  Action  List 
Internal  Schema  Qualify  List 
Set  Table 

ORACLE  Logon  Data  Area 
Error  File  Name 


Access  Path  Specification 
Code  Table 

Record  Key  Table 
Access  Path  Data 
Information  Table 
Error  status  code 


1 


3.4  Program  Interrupts 

Not  applicable  to  the  CPCI. 

3 . 5  Timing  and  Sequencing  Description 

This  CPCI  is  activated  for  each  CODASYL  database 
subtransaction  constructed  by  PRE5 .  The  timing  and  sequence  of 
the  call  to  this  CPCI  is  determined  by  the  support  routines 
CDP13 . 

3.6  Special  Control  Features 
Not  applicable  to  this  CPCI. 

3.7  Storage  Allocation 

3.7.1  Database  Definition 


The  database  used  by  this  CPCI  is  the  Common  Data  Model 
(CDM)  database.  The  model  is  defined  by  the  CDM1 ,  the  IDEF1 
model  of  the  CDM,  Reference  Document  Number  3. 

3. 7. 1.1  File  Description 
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SECTION  3 


REQUIREMENTS 


3. 1  Structural  Description 

The  graphic  portrayal  of  this  CPCI  is  included  in  Section 
3.10.  This  chart  shows  the  hierarchical  relationship  of  each 
module  making  up  this  CPCI. 

This  CPCI  uses  a  lower  level  module  to  identify  complete 
internal  schema  primary  or  secondary  keys  in  the  NDML  request 
(CDPR7KY). 

3.2  Functional  Flow 

This  CPCI  implemented  the  logic  defined  in  the  Development 
Specification  for  this  CPCI.  Details  of  inputs/outputs  and 
relationships  between  modules  are  found  in  Section  3.10. 

This  CPCI  has  been  designated  to  operate  in  a  batch  or 
interactive  mode.  It  must  operate  in  the  system  environment 
established  for  IISS;  that  is,  the  Network  Transaction  Manager . 
The  ORACLE  DBMS  installed  on  a  DEC  VAX  computer  must  be  used. 

3.3  Interfaces 

The  following  diagram  depicts  the  interface  of  PRE6  with 
other  CPCI ' s  in  the  system. 
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I  CDP13  I 
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3.3.1  Inputs /Outputs 

The  following  table  depicts  the  inputs  and  outputs  of  this 
CPCI .  A  detailed  description  for  each  item  can  be  found  in  the 
DS  for  this  CPCI. 

FUNCTION :  PRE6 

INPUT  OUTPUT 


Database  Identification  Number 
Current  Subtransaction 
Internal  Schema  Action  List 
Internal  Schema  Qualify  List 
Set  Table 

ORACLE  Logon  Data  Area 
Error  File  Name 


3.4  Program  Interrupts 

Not  applicable  to  the  CPCI. 

3 . 5  Timing  and  Sequencing  Description 

This  CPCI  is  activated  for  each  CODASYL  database 
subtransaction  constructed  by  PRE5 .  The  timing  and  sequence  of 
the  call  to  this  CPCI  is  determined  by  the  support  routines 
CDP13 . 

3.6  Special  Control  Features 
Not  applicable  to  this  CPCI. 

3 . 7  Storage  Allocation 

3.7.1  Database  Definition 


Access  Path  Specification 
Code  Table 

Record  Key  Table 
Access  Path  Data 
Information  Table 
Error  status  code 


The  database  used  by  this  CPCI  is  the  Common  Data  Model 
(CDM)  database.  The  model  is  defined  by  the  CDM1 ,  the  IDEF1 
model  of  the  CDM,  Reference  Document  Number  3. 

3. 7. 1.1  File  Description 
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Mo  permanent  files  have  been  defined  for  this  CPCI .  It  may 
use  temporary  scratoh  files  for  such  things  as  inputs  and 
results . 

3. 7. 1.2  Table  Description 

All  tables  used  by  this  CPCI  have  been  defined  by  the 
Development  Specification  for  this  CPCI. 

3. 7. 1.3  Item  Description 

Not  applicable  to  this  CPCI. 

3.8  Object  Code  Creation 

The  object  code  for  this  CPCI  will  be  created  by  the  system 
integration  team  using  defined  IISS  Software  Configuration 
Management  Procedures.  This  CPCI  will  use  the  COBOL  and  FORTRAN 
language  compilers.  This  CPCI  will  use  the  COBOL  language 
compilers . 

3.9  Adaptation  Data 

This  CPCI  has  been  coded  using  ANSI  COBOL  language.  The 
intent  was  to  provide  a  transportable  system.  Any  system 
environment  supporting  this  language,  a  virtual  memory 
management  schema,  the  COMM  and  NTM  subsystems  of  IISS  and  the 
ORACLE  Database  Management  System  should  be  able  to  support  this 
CPCI.  Every  possible  attempt  has  been  made  to  localise  and 
identify  any  machine  or  environment  dependent  modules  through 
the  original  design  of  the  IISS  and  application  of  Configuration 
Management  Procedures . 

3.10  Detail  Design  Description 

The  following  sections  have  been  computer  generated  for 
this  CPCI. 
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3.10.1  Main  Program  List 

The  following  is  a  list  of  all  "Main  Programs"  which  are 
modules  that  are  not  called  by  any  other  module  being  documented 
here.  These  modules  are  either  program  entry  points  or,  if  the* 
are  hooked  into  another  set  of  programs  via  subroutine  calls, 
they  are  the  points  the  external  programs  can  call  and  therefore 
enter  through.  To  differentiate  between  the  two  types  of  entry 
points,  look  at  the  individual  Module  Documentation  (section 
3.10.8)  and  look  at  Module  Type  for  each  of  the  Main  Program 
modules  listed.  Note  whether  the  routine  is  a  Program, 
Subroutine,  or  Function.  If  it  is  a  Program,  it  is  truly  a  main 
program  entry  point.  If  not,  then  it  is  merely  called  by  other 
programs  not  being  documented  here. 


PS  620141251 
1  November  1985 


Module 

CDDBTP 

CDPRE7 


SELECT  ACCESS  PATH  Main  Program  List 
Name  Purpose 

SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
SELECT  INTERNAL  SCHEMA  ACCESS  PATH 
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3.10.2  Module  List 

The  following  is  a  list  of  all  the  modules  being  documented 
here  along  with  their  purpose.  Each  module  has  a  unique  name, 
no  matter  what  language  it  was  written  in. 


"V  1 


Module  Name 

CDDBTP 

CDPR7KY 

CDPRE7 
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SELECT  ACCESS  PATH  Module  List 
Purpose 

SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 

RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


♦  4 

4 
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3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
ftr>*  caller,  in  alphabetical  order,  is  listel  a? 
veil  The  specification  in  which  any  module  is  documented  ma/ 
be  found  in  the  Module  Documentation  Index  (Document  Number  CM 
620100001).  See  section  3.10.6  for  a  list  of  the  modules  that 
call  each  of  these  external  routines. 
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SELECT  ACCESS  PATH  External  Routines  List 
Module  Name  First  User 


ERRPRO 

OBIHDN 

OCLOSE 

ODFINH 

OEXEC 

OFETCH 

OOPEN 

OSQL3 

RPTERR 


CDPR7KY 

CDPRE7 

CDPR7KY 

CDPRE7 

CDPRE7 

CDDBTP 

CDPR7KY 

CDDBTP 

CDPRE7 
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3.10.4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in  by 
modules  being  docunented  here.  Each  include  file  has  a  unique 
name  regardless  of  the  language  being  used.  The  purpose  of  each 
include  file  is  listed  as  well.  A  sore  complete  description  of 
each  include  file  is  given  in  section  3.10.9.  The  purpose 
listed  is  the  one  that  is  in  the  souroe  code  of  the  include 
file. 


A  purpose  of  "••••  PURPOSE  ROT  POUND  BT  STRIPPER  ••••" 
indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself.  The  most  common  reason  for  this  is  that 
the  include  file  comes  from  system  libraries  that  were  not 
developed  by  the  project,  suoh  as  'C'  libraries  that  are 
provided  with  the  'C'  compiler. 

See  section  3.10.6  for  a  set  of  lists  which  show  all  the 
modules  which  call  in  each  of  these  include  files. 
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SELECT  ACCESS  PATH  Include  File  List 


File  Marne 


Purpose 


APAT 

APGRP 

APIMFO 

APRK 

CHKCDM 

ERRCDM 

ERRPRO 

I  SAL 

ISQUAL 

ORCLEDA 

SETTAB 


ACCESS  PATH  TABLE 

SUBTRANSACTION  GROUPING  TABLE 

ACCESS  PATH  INFORMATION  TABLE 

TABLE  OF  RECORD  KEYS  FOR  CODASYL  ACCESS  PATHS 

IISS  CDMP  CHECK  STATUS  CODES 

IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

PROCESS  ERROR  INCLUDE  FILE 

INTERNAL  SCHEMA  ACTION  LIST 

INTERNAL  SCHEMA  QUALIFY  LIST 

VS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 

LIST  OF  SETS  OVNER-MEMBER  RELATIONSHIPS 
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3.10.5  Where  Include  File  Psed  List 

The  following  lists  each  include  file  from  3.10.4  and  all 
the  modules  documented  in  this  specification  which  include  thea. 
The  purpose  of  each  module  is  listed  as  well. 
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SELECT  ACCESS  PATH  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


APAT 

CDPRE7 


SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


APGRP 

CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


APINFO 

CDPRE7 


SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


APRK 


CDPR7KY 

CDPRE7 


RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 

THE  SUBTRANSACTION 

SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


CHKCDM 

CDDBTP  SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


ERRCDM 

CDDBTP 


SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
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SELECT  ACCESS  PATH  Vhere-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


CDPR7KY 

CDPRE7 


RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


ERRPRO 

CDDBTP  SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


I  SAL 

CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


ISQUAL 

CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


ORCLEDA 

CDDBTP  SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 
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SELECT  ACCESS  PATH  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


SETTAB 


CDPRE7 


SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


310-6  Where  External  Routine  Used  List 

The  following  lists  each  external  function 
listed  in  3.10.3  and  all  the  documented  modules 
The  purpose  of  each  module  is  listed  as  well. 
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or  routine 
which  call  it. 


PS  620141251 
1  November  1985 


SELECT  ACCESS  PATH  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


ERRPRO 

CDDBTP  SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


OBINDN 

CDDBTP  SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


OCLOSE 

CDDBTP  SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


ODFINN 

CDDBTP  SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


OEXEC 

CDDBTP  SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 
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SELECT  ACCESS  PATH  Where-external -routine-used  List 

System  Nodule  Module 

Module  Name  Purpose 


OFETCH 

CDDBTP  SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


OOPEN 

CDDBTP  SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


0SQL3 

CDDBTP  SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 

CDPRE7  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


RPTERR 

CDPR7KY  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 
THE  SUBTRANSACTION 
SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


CDPRE7 
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3.10.7  Main  Program  Parts  List 

The  following  lists  each  Main  Program  listed  in  3.10.1  and 
all  the  modules  which  are  called  either  by  that  module  itself  or 
by  any  of  the  documented  modules  which  it  calls.  It  is  possible 
for  a  non-main  module  to  be  listed  more  that  once  if  it  is 
called  by  multiple  modules.  The  oalled  modules,  in  this  case 
known  as  program  parts ,  are  marked  as  to  whether  they  are 
documented  here.  If  so,  the  phrase  "well-defined  module" 
appears  by  the  module  name,  if  not  it  is  am  "external  "routine". 
The  Purpose  of  the  Main  Program  module  is  listed  as  well. 
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SELECT  ACCESS  PATH  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Marne 

Name 

Type 

CDDBTP 

Purpose-- >  SEARCH  FOR  DB  SPECIFIC 
ATTRIBUTES . 

ERRPRO 

External 

routine 

OBINDN 

External 

routine 

OCLOSE 

External 

routine 

ODFINN 

External 

routine 

OEXEC 

External 

routine 

OFETCH 

External 

routine 

OOPEN 

External 

routine 

OSQL3 

External 

routine 
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SELECT  ACCESS  PATH  Main  Program  Parts  List 

Main  Pgn  Module  Module 

Name  Name  Type 


CDPRE7  Purpose — 

CDPR7KY 

ERRPRO 

OB I NON 

OCLOSE 

ODFINN 

OEXEC 

OFETCH 

OOPEN 

OSQL3 

RPTERR 


SELECT  INTERNAL  SCHEMA  ACCESS 
PATH 

Well-defined  nodule 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 


3-21 


PS  620141251 
1  November  1985 


3.10.8  Module  Documentation 

The  following  documentation  describes  information  which  is 
specific  to  each  individual  module  being  documented  in  this 
specification  as  listed  in  section  3.10.2.  It  provides  a 
compact  way  of  getting  information  that  would  be  otherwise 
buried  within  each  module's  source  code. 


The  specific  items  in  this  module  documentation  have  the 
following  meanings: 


NAME: 
PURPOSE : 

LANGUAGE : 


MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 

HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 


Name  of  program  Module. 

Purpose  of  Module  as  detai led  in  the 
source  code. 

Programming  language  source  code  is 
written  in. 

The  choices  are: 

VAX- 11  FORTRAN 
C 

Cl/s-l  Workbench  'C') 

VAX- 11  COBOL 

Whether  a  Program,  Subroutine,  or 
Function . 

Name  of  Source  File  from  file 
specification. 

Source  File  Extension  from  file 
specification. 

Whether  this  is  a  host -dependent 
routine  (VAX  or  IBM)  or  blank  if 
host- independent . 

IISS  sub-system  this  file  resides  in. 

Sub-directory  of  that  subsystem  in 
which  this  file  resides. 


DOCUMENTATION  GROUP:  Name  of  documentation  group  of  which 

this  source  file  is  a  member. 
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DESCRIPTION:  A  description  of  the  module  as  otained 

from  the  source  code. 

ARGUMENTS:  The  arguments  with  which  this  routine 

is  called  if  it  is  a  Subroutine  or  a 
Function. 

INCLUDE  FILES:  A  list  of  all  the  files  that  are 

included  into  this  module  as  well  as 
their  purposes. 

ROUTINES  CALLED:  Subroutines  or  Functions,  either 

documented  or  external,  called  by  this 
module,  if  any. 

CALLED  DIRECTLY  BY:  The  documented  routines  which  call  this 

module,  if  any. 

USED  IN  MAIN  PROGRAM(S):  The  documented  Main  Programs  which 

contain  this  module  in  their  parts  list 
according  to  the  list  in  section 
3.10.7. 


The  Module  Documentation  is  arranged  alphabetically 
according  to  Module  Name. 
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SELECT  ACCESS  PATH  Module  Docuaentat Ion 


NAME: 

PURPOSE 

LANGUAGE: 

NODULE  TYPE: 

SOURCE  PILE: 

SOURCE  FILE  TYPE 
BOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENT AT I OH  GROUP: 


CDDBTP 

SEARCH  FOR  DB  SPECIFIC  ATTRIBUTES. 
VAX- 11  COBOL 
SUBROUTINE 
CDDBTP 
COB 

CDM 

PS41251 


DESCRIPTION : 


-  CDDBTP  WILL  SUPPLY  CDM  INFORMATION 
ABOUT  A  DATA  BASE  GIVEN  THE  DB  ID. 

NOD  FOR  RELEASE  2.0  - 
STANDARDISE  ERROR  HANDLING  AND 
ADD  SCHEMA  NAMES  AMD  DB  PASSWORD .  OOMBIM 
INTO  ONE  SQL  STATEMENT  WITH  OUTER-JOINS 


ARGUMENTS 


IMPUT-DBID  -  DSPLY  [99999] 

ORACLE -LDA  -  RE CRD 

DBMS -NAME  -  DSPLY  [X(30>] 

MOST- ID  -  DSPLY  [XXX] 

DB-NAME  -  DSPLY  [X(30)] 
LIBRARY-NAME  -  DSPLY  [X(30)l 
SCHEMA-NAME  -  DSPLY  [X(30)J 
SUBSCHEMA -NAME  -  DSPLY  [X(30>] 
DB- LOCATION  -  DSPLY  [X(30)] 

DB- PASSWORD  -  DSPLY  [X(30)l 
RET-STATUS  -  DSPLY  [X(5)] 


INCLUDE  FILES: 


CHXCDM  -  IISS  CDMP  CHECK  STATUS  CODES 
ERRCDM  -  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

ORCLEDA  -  WS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 
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■OOTINK8  CALLED: 


OOPKM 

08QL3 

oornm 

OBIMDV 

OKXSC 

OPETCM 

OCLOSC 

EftllPRO 
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SELECT  ACCESS  PATH  Module  Documentation 


NAME :  CDPR7KY 

PURPOSE:  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN 

THE  SUBTRANSACTION 
LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE :  CDPR7KY 

SOURCE  FILE  TYPE:  .COB 

HOST: 

SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41251 
DESCRIPTION: 


SELECTS  ALL  THE  DATA  FIELDS  FOR  A  GIVEN  RTID, 
BUILDS  THE  COMPOSITE  KEYS,  SEARCHES 
THE  APPROPRIATE  IS  LIST  FOR  A  COMPLETE  KEY, 
THEN  RETURNS  INFO  ON  COMPLETE  KEYS 
IN  THE  RECORD-KEY  TABLE. 


CDM  RULES  and  ASSUMPTIONS: 

1.  If  a  group  data  item  is  flagged  as  a 
primary  key,  then  its  component  data  fields 
must  flagged  as  non-key  or  secondary  keys. 

2.  A  key  group  data  item  may  be  redefined, 

but  the  redefinition  must  also  be  flagged  as  key. 


3.  A  data  field  which  is  a  component  of  a  key 
may  not  be  redefined. 


If  CDM  has 
— df  id 

and  IS/ISQ  has 

key  code--  --df id-- 

then  RK-TABLE  has 
— dfid  key  code 

02  D 

H  p  N 

D 

D  only  "P" 

03  E 

"S"  E 

03  F 

F 

3-26 


PS  620141251 
1  November  1985 


02  BB 

“P" 

DD 

DD 

03  DD 

EE 

EE 

03  EE 

02  ABC  “P"  DE 

03  AB  "S" 

03  BC 

02  DEF  redefines  ABC 
03  DE  "S" 

03  EF 


DE  "S“ 


ARGUMENTS : 


DBID  -  DSPLY  [9(5)] 

SUB- ID  -  DSPLY  [9(3)] 

IS -ACTION-LIST  -  RECRD 
IS -QUALIFY -LI ST  -  RECRD 
GROUP-TABLE  -  RECRD 
ORACLE -LDA  -  RECRD 
ERROR-FILE  -  DSPLY  [X(30)] 

RECORD- KEY-TABLE  -  RECRD 

QCS -CDMP -CHECK- STATUS  -  DSPLY  [X(5)J 


INCLUDE  FILES: 


ERRCDM 

I  SAL 

ISQUAL 

APGRP 

ORCLEDA 

APRK 

CHKCDM 

ERRPRO 


IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
INTERNAL  SCHEMA  ACTION  LIST 
INTERNAL  SCHEMA  QUALIFY  LIST 
SUBTRANSACTION  GROUPING  TABLE 
WS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 
TABLE  OF  RECORD  KEYS  FOR  CODASYL  ACCESS  PATHS 
IISS  CDMP  CHECK  STATUS  CODES 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


OOPEN 

OCLOSE 

OFETCH 

0SQL3 

ODFINN 

OBINDN 
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OEXEC 

RPTERR 

ERRPRO 

CALLED  DIRECTLY  BY: 

CDPRE7  -  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 

USED  IN  MAIN  PROGRAM(S) : 

CDPRE7  -  SELECT  INTERNAL  SCHEMA  ACCESS  PATH 


PS  620141251 
1  November  1985 


SELECT  ACCESS  PATH  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


CDPRE7 

SELECT  INTERNAL  SCHEMA  ACCESS  PATH 

VAX- 11  COBOL 

SUBROUTINE 

CDPRE7 

.COB 


SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41251 


DESCRIPTION: 


-  SELECT  AN  ACCESS  PATH  THRU  A  OODYSYL 
DATABASE  TO  SATISFY  AN  NDML  QUERY 

-  All  entries  in  the  IS-ACTION  are 
processed.  Only  type  2  and  type  3  entries 
from  the  IS-QUALIFY  are  processed.  Not 
all  entries  in  the  set  table  necessarily 
map  to  the  IS  and  ISQ  tables . 


ARGUMENTS : 


DBID  -  DSPLY  [9(5)] 

SUB- ID  -  DSPLY  [9(3)] 

IS-ACTION-LIST  -  RECRD 

IS -QUALIFY -LI ST  -  RECRD 

SET-TABLE  -  RECRD 

ORACLE -LDA  -  RECRD 

ERROR-FILE  -  DSPLY  [X(30)] 

ACCESS-PATHS  -  RECRD 

RECORD-KEY -TABLE  -  RECRD 

AP- INFO-TABLE  -  RECRD 

QCS -CDM P -CHECK -STATUS  -  DSPLY  [ X( 5 ) ] 


INCLUDE  FILES: 


APGRP  -  SUBTRANSACTION  GROUPING  TABLE 

ERRCDM  -  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
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1SAL 

ISQUAL 

SETTAB 

ORCLEDA 

CHKCDM 

APAT 

APINFO 

APRK 

ERRPRO 


INTERNAL  SCHEMA  ACTION  LIST 

INTERNAL  SCHEMA  QUALIFY  LIST 

LIST  OF  SETS  OWNER-MEMBER  RELATIONSHIPS 

WS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 

IISS  CDMP  CHECK  STATUS  CODES 

ACCESS  PATH  TABLE 

ACCESS  PATH  INFORMATION  TABLE 

TABLE  OF  RECORD  KEYS  FOR  CODASYL  ACCESS  PATHS 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


CDPR7KY  -  RETURNS  COMPLETE  KEYS  FOR  EACH  RECORD  IN  THE 

SUBTRANSACTION 

RPTERR 

OCLOSE 

OOPEN 

OFETCH 

0SQL3 

ODFINN 

OBINDN 

OEXEC 

ERRPRO 
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3.10.9  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 
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SELECT  ACCESS  PATH  Include  Pile  Description 


FILE  NAME  APAT 

PURPOSE:  ACCESS  PATH  TABLE 

LANGUAGE :  VAX- 1 1  COBOL 

DESCRIPTION: 


CONTAINS  THE  ACCESS  PATH  FOR  ONE  SUBTRANSACTION 
FOR  A  NDML  REQUEST. 
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SELECT  ACCESS  PATH  Include  File  Description 
FILE  NAME:  APGRP 

PURPOSE:  SUBTRANSACTION  GROUPING  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 

Definition  of  the  GROUP-TABLE  local  to  the 
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SELECT  ACCESS  PATH  Include  File  Description 


FILE  NAME:  APINFO 

PURPOSE:  ACCESS  PATH  INFORMATION  TABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  IS  A  COLLECTION  OF  INFORMATION  STORED  IN  A 

NUMBER  OF  VARIOUS  TABLES  USED  BY  THE  ACCESS  PATH  TABLE 
AND  THE  GENERIC  CODASYL  TABLE.  SEE  CDMP  SPEC,  PRE6 


APINFO. INC 
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SELECT  ACCESS  PATH  Include  File  Description 


FILE  NAME:  APRK 

PURPOSE:  TABLE  OF  RECORD  KEYS  FOR  CODASYL  ACCESS  PATHS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INFORMATION  FOR  THE  KEYS  OF 
RECORDS  CONTAINED  IN  THE  CURRENT  ACCESS 
PATH 
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SELECT  ACCESS  PATH  Include  File  Description 


FILE  NAME:  CHKCDM 

PURPOSE:  IISS  CDMP  CHECK  STATUS  CODES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  STATUS  CODES  FOR  THE 
CDMP  MODULES 
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SELECT  ACCESS  PATH  Include  File  Description 


FILE  NAME:  ERRCDM 

PURPOSE:  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  ERROR  CODES  USED  BY  CDMP 
MODULES  FOR  ERROR  HANDLING 
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SELECT  ACCESS  PATH  Include  File  Description 


FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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SELECT  ACCESS  PATH  Include  File  Description 


FILE  NAME:  I SAL 

PURPOSE:  INTERNAL  SCHEMA  ACTION  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  INTERNAL  SCHEMA  INFORMATION  ABOUT  AN 
NDML  REQUEST 


THE  INTERNAL  SCHEMA  ACTION  LIST 


3-39 


PS  620141251 
1  November  1985 


SELECT  ACCESS  PATH  Include  File  Description 


FILE  NAME:  ISQUAL 

PURPOSE:  INTERNAL  SCHEMA  QUALIFY  LIST 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION : 


CONTAINS  INTERNAL  SCHEMA  INFORMATION  FOR  AN 
NDML  QULIFICATION 


THE  INTERNAL  SCHEMA  QUALIFY  LIST 
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SELECT  ACCESS  PATH  Include  File  Description 


FILE  NAME:  ORCLEDA 

PURPOSE:  WS  DEFINITION  FOR  THE  ORACLE  LOGIN  AREA 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


I  THE  ORACLE  LOGON  DATA  AREA 
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SELECT  ACCESS  PATH  Include  File  Description 


FILE  NAME:  SETTAB 

PURPOSE:  LIST  OF  SETS  OWNER-MEMBER  RELATIONSHIPS 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


SET  TABLE  TO  KEEP  TRACK  OF  CODASYL  NDML  REQUESTS 
IN  TERMS  OF  OWNER  AND  MEMBER  RELATIONSHIPS 


4 


i 
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3.10.10  Hierarchy  Chari 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  nodules  mentioned  in  the  above  doounentation . 
A  nodule  nay  call  a  subroutine  several  tines  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  nodules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above . 

There  is  an  internal  paging  scheme  as  narked  by  the  nunbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  linb  shows  where  that  the  tree  continues  on  the  page 
nunbered  nentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
the  hierarchy  tree.  If  there  is  no  number  in  a  box,  the  routine 
either  nakes  no  calls  or  is  an  external  routine. 
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1 

+ - +  + - + 

I CDDBTP I  I CDPRE7 I 

+  --+ +  + - 2+ 

I 

+ - + - + - + - + - + - + 

III  I  II 

+--+ +  +--+ - +  + — + + 

lOOPENI  I0SQL3I  IODFINNI  IOBINDNI  lOEXECl  I (OONT) I 
+ - +  + - +  + - +  + - +  + - +  + - 3+ 


f 
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+ - + 

I CDPRE7 I 


—  + 

1 

| 

+ - + - + 

1 CDPR7KY 1 
+ - 4+ 

+ — + - + 

IRPTERRI 
+ - + 

+  --+ + 

IOCLOSEI 
+ - + 

1 OOPEN 1 
+ - + 

+--+ - + 

IOFETCH 1 
+ - + 

+ — + - + 

1 (CONT) 1 
+ - 5+ 

i 
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3 

+ - + 

I CDDBTP I 

+  —  + - + 

+ - + - + - + - + 

I  I  I  I 

+ — + - +  + —  + - +  +--+ - +  +  — + - + 

I ( CONT ) I  IOFETCHI  IOCLOSEI  IERRPROI 

+ - 1+  + - +  + - +  + - + 


PS  620141251 
1  November  1985 


+ - + 

I CDPR7KY I 


+ - +■ 

- + 

1 

1 

1 

1 

| 

+ — + — + 

IOOPENI 

+ - + 

+ —  + - + 

IOCLOSE 1 
+ - + 

4- - 4. - + 

I0FETCHI 
+ - + 

+ — + — + 
I0SQL3I 
+ - + 

+ — + - + 

lODFINN 1 

+ - + 

+ — + + 

1 (CONT) 1 
+ - 6+ 
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5 

+ - + 

I CDPRE7 I 

+  --  + + 

I 

+ - + + - + - + - + + 

I  II  I  II 

+  --  + - +  + — + — +  + — + - +  +  — + - +  + — + — +  +--+ - + 

I (CONT) I  I0SQL3I  lODFINNl  lOBINDN I  IOEXECI  I ERRPRO I 

+ - 2+  + - +  + - +  + - +  + - +  + - + 
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I CDPR7KY I 

+ - + - + 

I 

I  I  I  I  I 

+ — + - +  + — + +  +--+ +  +--+ + 

I (CONT) I  lOBINDN I  lOEXECl  I RPTERR I  lERRPROl 
+ - 4+  + - +  + - +  + - +  + - + 
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CDDBTP . 1 

CDPR7KY ....  4 

CDPKi;? . 2 

ERRPRO 

OBINDN 

OCLOSE 

ODFINN 

OEXEC 

OFETCH 

OOPEN 

0SQL3 

RPTERR 
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3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4 . 1  Introduction  mad  Definition* 

“Testing"  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated  Test  techniques  and  procedures  nay  be 
defined  in  advance,  and  a  sequence  of  test  steps  nay  be 
specified.  “ Debugg i ng “  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error 

“Antlbugglng*  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  ns  Ire  bugs  lass  likely  to  oc.ur  ano 
when  they  do  occur,  to  make  thee  more  noticeable  to  the 
progra aeer  and  the  user  In  other  words,  as  euch  error  check  inf 
as  is  practical  and  possible  in  each  routine  should  be 
performed . 

4 . 2  Computer  Programming  Test  amd  Evaluation 

The  quality  assurance  provisions  for  test  consist!  of  th« 
normal  testing  techniques  that  are  accomplished  during  u»* 
construction  process  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing  The*., 
tests  are  performed  by  the  design  team  structured  design 
design  walk -through  and  the  incorporation  of  "ant  i  bugf  i  r»g  ' 
facilitate  this  testing  by  exposing  and  addressing  problen 
before  they  become  coded  “bugs  * 
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